<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    <title>Installation | Raxan User Guide</title>
    <link href="../raxan/styles/master.css" rel="stylesheet" type="text/css" />
    <!--[if IE]><link rel="stylesheet" href="../raxan/styles/master.ie.css" type="text/css"><![endif]-->
    <link href="style.css" rel="stylesheet" type="text/css" />
    <link href="highlight/styles/default.css" rel="stylesheet" type="text/css" />
    <script type="text/javascript" src="highlight/highlight.js"></script>
    <script type="text/javascript">
        hljs.initHighlightingOnLoad('javascript','html','php');
    </script>

</head>

<body>
    <div class="container c48 prepend-top">
        <h2 class="bottom">Raxan User Guide</h2>
        <div class="navbar">
            <div class="lf"><div class="rt"><div class="md">
                <ul>
                    <li><a href="../index.html" title="The Rich Ajax, CSS &amp; PHP Framework" >Home</a></li>
                    <li><a href="table-of-contents.html" title="Blog Posts" >Table Of Contents</a></li>
                    <li><a href="../php-examples/index.php" title="PHP Examples" >PHP Examples</a></li>
                    <li><a href="../css-examples/index.html" title="User Guide" >CSS Examples</a></li>
                </ul>
            </div></div></div>
        </div>
        <div class="prepend1 append1">
            <div class="ltm" align="right">
                <a href="table-of-contents.html" title="Show Table of Content">
                    <img src="images/toc-button.png"  alt="Table of Contents" />
                </a>
            </div>
            <h2>Download and Installation Instructions</h2>

<p>To download latest version of the framework, visit the Raxan Download web page located at <a href="http://raxanpdi.com/downloads.html">http://raxanpdi.com/downloads.html</a>.  If you're a PHP developer and would like to use the built-in PHP/Ajax features, then you need to download the Raxan for PHP zip file. If you're only looking for the JavaScript/CSS framework then download Raxan for CSS zip file.</p>

<p>For a list of basic requirements see "<a href="requirements.html">Software Requirements</a>"</p>

<h3>Installation</h3>

<p>After downloading the file, unzip the content of the file (e.g. raxan-php.1.0.0.zip or raxan-css.1.0.0.zip) into a folder on your local PC (e.g. c:\development\raxanfiles) or your web server. Installing Raxan is as simple as copying the files and folders to another server or folder location. No special installation program or script is required.</p>

<p>Note: When installing on a web server, make sure that the files are placed in a location on your web server (e.g. the web root folder) that can be accessed via a browser.</p>

<h3>Directory Structure</h3>

<p><img src="images/directory.png"  align="right" alt="Directory Structure" />
Inside the main Raxan folder you will find the file startup.js. This is the framework's main JavaScript startup file.
The plugins folder is used for storing Raxan plugins or other JavaScript library files. For example, you can add files to the plugins folder such as jQuery, mootools, etc and dynamically include them when needed. Later on, we will look at how to include JavaScript libraries when needed.</p>

<p>The styles folder is used for storing cascading style sheets and images. Inside this folder you will find the master.css file that contains the CSS classes for building complex layouts. In addition, you will also find a default folder that contains the default theme for the framework. Additional themes can be added and optionally loaded when necessary.</p>

<p>The templates folder is basic a storage area for html templates that can be used to help simplify or speed up development.</p>

<p>The PDI folder is only available if you had downloaded the PDI version of the framework. This folder stores the Raxan Classes, locale and sample configuration files.</p>

<p>If you would like to adjust the default settings or behavior, you can optionally create a configuration file for your project or website.</p>

<h3>Creating a PDI Configuration File</h3>

<p>To create your custom configuration file, copy (or rename) the raxan/pdi/gateway.config.sample.php to gateway.config.php</p>

<p>Using a text editor, edit the content of gateway.config.php by adding the necessary folder paths and/or database login information.</p>

<p>On shared linux systems you should set your config file to 644 or 600 to prevent others from making changes to your config settings. It's also recommended that your ISP run the suphp Apache module for added security.</p>

<h3>Changing the default Raxan Path</h3>

<p>JavaScript developers can optionally change the default path by setting the 'path' property on the Raxan object. For example: Raxan.path = '/path/to/raxan/'. The same can be done for the csspath and pluginspath. Note: The new url must have a trailing slash (/)</p>

<p>For PHP developers, set the <strong>raxan.url</strong> and <strong>raxan.path</strong> options inside your gateway.config.php file. For more information see <a href="custom-config.html">Loading A Custom Configuration File</a></p>

<pre><code>&lt;?php

$config['raxan.url'] = '/url/address/to/raxan/';
$config['raxan.path'] = '/folder/path/to/raxan/';

?&gt;
</code></pre>

        </div>
        <div class="tpb pad" style="text-align:right">
            <div class="right ltm">
                <a href="table-of-contents.html" title="Back to Table of Content">
                    <img src="images/toc-button.png"  alt="Table of Contents" />
                </a>
            </div>
        </div>
    </div>
</body>

</html>

